Класс 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
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
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 |
defaultEditorsByColumnClass |
Таблица объектов, отображающих и редактирующих содержимое ячейки, индексированная по классу, как объявлено в getColumnClass в интерфейсе TableModel. |
protected Hashtable |
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 |
Создает JTable с numRows и numColumns пустых ячеек с использованием DefaultTableModel. |
JTable |
Создает JTable для отображения значений в двумерном массиве rowData с именами столбцов columnNames. |
JTable |
Создает JTable для отображения значений в Vector из Vectors, rowData, с именами столбцов columnNames. |
JTable |
Создает JTable, инициализированный моделью данных dm, моделью столбцов по умолчанию и моделью выделения по умолчанию. |
JTable |
Создает JTable, инициализированный моделью данных dm, моделью столбцов cm и моделью выделения по умолчанию. |
JTable |
Создает JTable, инициализированный моделью данных dm, моделью столбцов cm и моделью выделения sm. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addColumn |
Добавляет aColumn в конец массива столбцов, удерживаемых моделью столбцов этого JTable. |
void |
addColumnSelectionInterval |
Добавляет столбцы от index0 до index1 включительно в текущее выделение. |
void |
addNotify() |
Вызывает метод configureEnclosingScrollPane. |
void |
addRowSelectionInterval |
Добавляет строки от index0 до index1 включительно в текущее выделение. |
void |
changeSelection |
Обновляет модели выделения таблицы в зависимости от состояния двух флагов: toggle и extend. |
void |
clearSelection() |
Снимает выделение со всех выбранных столбцов и строк. |
void |
columnAdded |
Вызывается при добавлении столбца в модель столбцов таблицы. |
int |
columnAtPoint |
Возвращает индекс столбца, в котором находится point, или -1, если результат не входит в диапазон [0, getColumnCount()-1]. |
void |
columnMarginChanged |
Вызывается при перемещении столбца из-за изменения отступа. |
void |
columnMoved |
Вызывается при изменении положения столбца. |
void |
columnRemoved |
Вызывается при удалении столбца из модели столбцов таблицы. |
void |
columnSelectionChanged |
Вызывается при изменении модели выделения у TableColumnModel. |
protected void |
configureEnclosingScrollPane() |
Если этот JTable является viewportView для объемлющего JScrollPane (обычная ситуация), настраивает этот ScrollPane, помимо прочего, устанавливая tableHeader таблицы в качестве columnHeaderView панели прокрутки. |
int |
convertColumnIndexToModel |
Сопоставляет индекс столбца в представлении по адресу viewColumnIndex с индексом столбца в модели таблицы. |
int |
convertColumnIndexToView |
Сопоставляет индекс столбца в модели таблицы по адресу modelColumnIndex с индексом столбца в представлении. |
int |
convertRowIndexToModel |
Сопоставляет индекс строки в представлении с базовой TableModel. |
int |
convertRowIndexToView |
Сопоставляет индекс строки в 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 |
Устарело. |
void |
doLayout() |
Заставляет эту таблицу выполнить компоновку своих строк и столбцов. |
boolean |
editCellAt |
Программно начинает редактирование ячейки в позиции row и column, если эти индексы находятся в допустимом диапазоне, а ячейка с этими индексами доступна для редактирования. |
boolean |
editCellAt |
Программно начинает редактирование ячейки в позиции row и column, если эти индексы находятся в допустимом диапазоне, а ячейка с этими индексами доступна для редактирования. |
void |
editingCanceled |
Вызывается при отмене редактирования. |
void |
editingStopped |
Вызывается по завершении редактирования. |
AccessibleContext |
getAccessibleContext() |
Получает AccessibleContext, связанный с этим объектом JTable. |
boolean |
getAutoCreateColumnsFromModel() |
Определяет, будет ли таблица создавать столбцы по умолчанию из модели. |
boolean |
getAutoCreateRowSorter() |
Возвращает true, если при каждом изменении модели должен создаваться и устанавливаться в качестве сортировщика таблицы новый RowSorter; в противном случае возвращает false. |
int |
getAutoResizeMode() |
Возвращает режим автоматического изменения размера таблицы. |
TableCellEditor |
getCellEditor() |
Возвращает активный редактор ячеек или null, если в данный момент таблица не редактируется. |
TableCellEditor |
getCellEditor |
Возвращает подходящий редактор для ячейки, заданной через row и column. |
Rectangle |
getCellRect |
Возвращает прямоугольник для ячейки, находящейся на пересечении строки row и столбца column. |
TableCellRenderer |
getCellRenderer |
Возвращает подходящий визуализатор для ячейки, заданной этой строкой и столбцом. |
boolean |
getCellSelectionEnabled() |
Возвращает true, если включены обе модели выделения — строк и столбцов. |
TableColumn |
getColumn |
Возвращает объект TableColumn для столбца таблицы, идентификатор которого равен identifier при сравнении с помощью equals. |
Class |
getColumnClass |
Возвращает тип столбца, отображаемого в представлении в позиции столбца column. |
int |
getColumnCount() |
Возвращает количество столбцов в модели столбцов. |
TableColumnModel |
getColumnModel() |
Возвращает TableColumnModel, содержащий всю информацию о столбцах этой таблицы. |
String |
getColumnName |
Возвращает имя столбца, отображаемого в представлении в позиции столбца column. |
boolean |
getColumnSelectionAllowed() |
Возвращает true, если столбцы можно выбирать. |
TableCellEditor |
getDefaultEditor |
Возвращает редактор, используемый, когда в TableColumn не задан редактор. |
TableCellRenderer |
getDefaultRenderer |
Возвращает визуализатор ячеек, используемый, когда в 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 |
Возвращает Printable для использования при печати этого JTable. |
int |
getRowCount() |
Возвращает количество строк, которые могут быть показаны в JTable при неограниченном пространстве. |
int |
getRowHeight() |
Возвращает высоту строки таблицы в пикселях. |
int |
getRowHeight |
Возвращает высоту (в пикселях) ячеек в row. |
int |
getRowMargin() |
Возвращает размер пустого пространства (в пикселях) между ячейками. |
boolean |
getRowSelectionAllowed() |
Возвращает true, если строки можно выбирать. |
RowSorter |
getRowSorter() |
Возвращает объект, отвечающий за сортировку. |
int |
getScrollableBlockIncrement |
Возвращает visibleRect.height или visibleRect.width в зависимости от ориентации этой таблицы. |
boolean |
getScrollableTracksViewportHeight() |
Возвращает false, указывая, что высота области просмотра не определяет высоту таблицы, если только getFillsViewportHeight не равно true и предпочтительная высота таблицы не меньше высоты области просмотра. |
boolean |
getScrollableTracksViewportWidth() |
Возвращает false, если autoResizeMode установлено в AUTO_RESIZE_OFF, что указывает на то, что ширина области просмотра не определяет ширину таблицы. |
int |
getScrollableUnitIncrement |
Возвращает шаг прокрутки (в пикселях), который полностью отображает одну новую строку или столбец (в зависимости от ориентации). |
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 |
Переопределяет метод getToolTipText класса JComponent, чтобы разрешить использование подсказок визуализатора, если для него задан текст. |
TableUI |
getUI() |
Возвращает объект L&F, визуализирующий этот компонент. |
String |
getUIClassID() |
Возвращает суффикс, используемый для построения имени класса L&F, применяемого для визуализации этого компонента. |
boolean |
getUpdateSelectionOnSort() |
Возвращает true, если выделение должно обновляться после сортировки. |
Object |
getValueAt |
Возвращает значение ячейки в позиции row и column. |
protected void |
initializeLocalVars() |
Инициализирует свойства таблицы их значениями по умолчанию. |
boolean |
isCellEditable |
Возвращает true, если ячейка в позиции row и column доступна для редактирования. |
boolean |
isCellSelected |
Возвращает true, если указанные индексы находятся в допустимом диапазоне строк и столбцов, а ячейка в указанной позиции выбрана. |
boolean |
isColumnSelected |
Возвращает true, если указанный индекс находится в допустимом диапазоне столбцов, а столбец с этим индексом выбран. |
boolean |
isEditing() |
Возвращает true, если ячейка редактируется в данный момент. |
boolean |
isRowSelected |
Возвращает true, если указанный индекс находится в допустимом диапазоне строк, а строка с этим индексом выбрана. |
void |
moveColumn |
Перемещает столбец column на позицию, которую в представлении в данный момент занимает столбец targetColumn. |
protected String |
paramString() |
Возвращает строковое представление этой таблицы. |
Component |
prepareEditor |
Подготавливает редактор, запрашивая у модели данных значение и состояние выделения ячейки в позиции row, column. |
Component |
prepareRenderer |
Подготавливает визуализатор, запрашивая у модели данных значение и состояние выделения ячейки в позиции row, column. |
boolean |
print() |
Удобный метод, который отображает диалоговое окно печати, а затем выводит на печать этот JTable в режиме PrintMode.FIT_WIDTH без верхнего или нижнего колонтитулов. |
boolean |
print |
Удобный метод, который отображает диалоговое окно печати, а затем выводит на печать этот JTable в указанном режиме печати без верхнего или нижнего колонтитулов. |
boolean |
print |
Удобный метод, который отображает диалоговое окно печати, а затем выводит на печать этот JTable в указанном режиме печати с заданным текстом верхнего и нижнего колонтитулов. |
boolean |
print |
Выводит эту таблицу на печать в соответствии с полнофункциональным методом print, при этом принтер по умолчанию задается в качестве службы печати. |
boolean |
print |
Выводит на печать этот JTable. |
void |
removeColumn |
Удаляет aColumn из массива столбцов этого JTable. |
void |
removeColumnSelectionInterval |
Снимает выделение со столбцов от index0 до index1 включительно. |
void |
removeEditor() |
Удаляет объект редактора и освобождает область экрана, которую он использовал для отображения ячейки. |
void |
removeNotify() |
Вызывает метод unconfigureEnclosingScrollPane. |
void |
removeRowSelectionInterval |
Снимает выделение со строк от index0 до index1 включительно. |
protected void |
resizeAndRepaint() |
Эквивалентно revalidate с последующим вызовом repaint. |
int |
rowAtPoint |
Возвращает индекс строки, в которой находится point, или -1, если результат не входит в диапазон [0, getRowCount()-1]. |
void |
selectAll() |
Выделяет все строки, столбцы и ячейки в таблице. |
void |
setAutoCreateColumnsFromModel |
Устанавливает для этой таблицы флаг autoCreateColumnsFromModel. |
void |
setAutoCreateRowSorter |
Указывает, должен ли создаваться RowSorter для таблицы при каждом изменении ее модели. |
void |
setAutoResizeMode |
Устанавливает режим автоматического изменения размера таблицы при изменении ее размера. |
void |
setCellEditor |
Устанавливает активный редактор ячеек. |
void |
setCellSelectionEnabled |
Задает, разрешает ли эта таблица одновременное существование выделения столбцов и выделения строк. |
void |
setColumnModel |
Устанавливает модель столбцов для этой таблицы в columnModel и регистрируется для получения уведомлений слушателя от новой модели столбцов. |
void |
setColumnSelectionAllowed |
Задает, могут ли столбцы в этой модели быть выделены. |
void |
setColumnSelectionInterval |
Выделяет столбцы от index0 до index1 включительно. |
void |
setDefaultEditor |
Устанавливает редактор ячеек по умолчанию, который будет использоваться, если в TableColumn не задан редактор. |
void |
setDefaultRenderer |
Устанавливает визуализатор ячеек по умолчанию, который будет использоваться, если в TableColumn не задан визуализатор. |
void |
setDragEnabled |
Включает или выключает автоматическую обработку перетаскивания (drag). |
final void |
setDropMode |
Устанавливает режим сброса (drop mode) для этого компонента. |
void |
setEditingColumn |
Устанавливает переменную editingColumn. |
void |
setEditingRow |
Устанавливает переменную editingRow. |
void |
setFillsViewportHeight |
Задает, будет ли эта таблица всегда достаточно большой, чтобы заполнить высоту объемлющей области просмотра. |
void |
setGridColor |
Устанавливает цвет, используемый для отрисовки линий сетки, в gridColor и обновляет отображение. |
void |
setIntercellSpacing |
Устанавливает rowMargin и columnMargin — высоту и ширину промежутка между ячейками — в intercellSpacing. |
void |
setModel |
Устанавливает модель данных для этой таблицы в dataModel и регистрируется в ней для получения уведомлений слушателя от новой модели данных. |
void |
setPreferredScrollableViewportSize |
Устанавливает предпочтительный размер области просмотра для этой таблицы. |
void |
setRowHeight |
Устанавливает высоту всех ячеек в пикселях в rowHeight, выполняет повторную валидацию и перерисовывает. |
void |
setRowHeight |
Устанавливает высоту для row в rowHeight, выполняет повторную валидацию и перерисовывает. |
void |
setRowMargin |
Устанавливает размер пустого пространства между ячейками в соседних строках. |
void |
setRowSelectionAllowed |
Задает, могут ли строки в этой модели быть выделены. |
void |
setRowSelectionInterval |
Выделяет строки от index0 до index1 включительно. |
void |
setRowSorter |
Устанавливает RowSorter. |
void |
setSelectionBackground |
Устанавливает цвет фона для выбранных ячеек. |
void |
setSelectionForeground |
Устанавливает цвет переднего плана для выбранных ячеек. |
void |
setSelectionMode |
Устанавливает режим выделения таблицы, разрешая выбор только одного элемента, одного непрерывного интервала или нескольких интервалов. |
void |
setSelectionModel |
Устанавливает модель выделения строк для этой таблицы в selectionModel и регистрируется для получения уведомлений слушателя от новой модели выделения. |
void |
setShowGrid |
Задает, рисует ли таблица линии сетки вокруг ячеек. |
void |
setShowHorizontalLines |
Задает, рисует ли таблица горизонтальные линии между ячейками. |
void |
setShowVerticalLines |
Задает, рисует ли таблица вертикальные линии между ячейками. |
void |
setSurrendersFocusOnKeystroke |
Задает, получают ли редакторы в этом JTable фокус клавиатуры, когда редактор активируется в результате пересылки объектом JTable событий клавиатуры для ячейки. |
void |
setTableHeader |
Устанавливает tableHeader, работающий с этим JTable, в newHeader. |
void |
setUI |
Устанавливает объект L&F, визуализирующий этот компонент, и выполняет перерисовку. |
void |
setUpdateSelectionOnSort |
Указывает, должно ли выделение обновляться после сортировки. |
void |
setValueAt |
Задает значение для ячейки в модели таблицы в позиции row и column. |
void |
sizeColumnsToFit |
Устарело. Начиная с версии Swing 1.0.3, заменено на doLayout(). |
void |
sizeColumnsToFit |
Устарело, начиная с платформы Java 2 v1.4. |
void |
sorterChanged |
RowSorterListener уведомление о том, что RowSorter каким-либо образом изменился. |
void |
tableChanged |
Вызывается, когда TableModel этой таблицы генерирует TableModelEvent. |
protected void |
unconfigureEnclosingScrollPane() |
Отменяет действие configureEnclosingScrollPane путем замены columnHeaderView вмещающей панели прокрутки на null. |
void |
updateUI() |
Уведомление от UIManager об изменении L&F. |
void |
valueChanged |
Вызывается при изменении выбора строки — перерисовывает компонент для отображения нового выделения. |
Методы, объявленные в классе 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 |
Регистрирует listener для получения AncestorEvents при перемещении самого компонента или любого из его предков, а также при изменении их видимости. |
void |
addVetoableChangeListener |
Добавляет VetoableChangeListener в список слушателей. |
void |
computeVisibleRect |
Возвращает "видимый прямоугольник" компонента Component — пересечение видимых прямоугольников для этого компонента и всех его предков. |
boolean |
contains |
Предоставляет делегату 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 |
Поддержка создания отчетов об изменениях связанных логических (boolean) свойств. |
void |
firePropertyChange |
Поддержка создания отчетов об изменениях связанных целочисленных (integer) свойств. |
protected void |
fireVetoableChange |
Поддержка создания отчетов об изменениях свойств с ограничениями (constrained properties). |
ActionListener |
getActionForKeyStroke |
Возвращает объект, который будет выполнять действие, зарегистрированное для заданной комбинации клавиш. |
final ActionMap |
getActionMap() |
Возвращает ActionMap, используемый для определения того, какое Action вызывать для конкретной привязки KeyStroke. |
float |
getAlignmentX() |
Переопределяет Container.getAlignmentX для возврата выравнивания по горизонтали. |
float |
getAlignmentY() |
Переопределяет Container.getAlignmentY для возврата выравнивания по вертикали. |
AncestorListener[] |
getAncestorListeners() |
Возвращает массив всех слушателей предков, зарегистрированных на этом компоненте. |
boolean |
getAutoscrolls() |
Возвращает свойство autoscrolls. |
int |
getBaseline |
Возвращает базовую линию. |
Component.BaselineResizeBehavior |
getBaselineResizeBehavior() |
Возвращает перечисление, указывающее, как базовая линия компонента изменяется при изменении размера. |
Border |
getBorder() |
Возвращает границу этого компонента или null, если граница в данный момент не установлена. |
Rectangle |
getBounds |
Сохраняет границы этого компонента в "возвращаемое значение" rv и возвращает rv. |
final Object |
getClientProperty |
Возвращает значение свойства с указанным ключом. |
protected Graphics |
getComponentGraphics |
Возвращает графический объект, используемый для отрисовки этого компонента. |
JPopupMenu |
getComponentPopupMenu() |
Возвращает JPopupMenu, назначенный для этого компонента. |
int |
getConditionForKeyStroke |
Возвращает условие, определяющее, выполняется ли зарегистрированное действие в ответ на указанное нажатие клавиши. |
int |
getDebugGraphicsOptions() |
Возвращает состояние отладки графики. |
static Locale |
getDefaultLocale() |
Возвращает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании. |
FontMetrics |
getFontMetrics |
Получает FontMetrics для указанного Font. |
Graphics |
getGraphics() |
Возвращает графический контекст этого компонента, который позволяет рисовать на нем. |
int |
getHeight() |
Возвращает текущую высоту этого компонента. |
boolean |
getInheritsPopupMenu() |
Возвращает true, если JPopupMenu должен наследоваться от родительского компонента. |
final InputMap |
getInputMap() |
Возвращает InputMap, который используется, когда компонент находится в фокусе. |
final InputMap |
getInputMap |
Возвращает InputMap, который используется во время condition. |
InputVerifier |
getInputVerifier() |
Возвращает верификатор ввода для этого компонента. |
Insets |
getInsets() |
Если для этого компонента установлена граница, возвращает отступы границы; в противном случае вызывает super.getInsets. |
Insets |
getInsets |
Возвращает объект Insets, содержащий значения внутренних отступов (insets) этого компонента. |
<T extends EventListener> |
getListeners |
Возвращает массив всех объектов, зарегистрированных в данный момент как FooListener для этого JComponent. |
Point |
getLocation |
Сохраняет координаты x,y начала этого компонента в "возвращаемое значение" rv и возвращает rv. |
Dimension |
getMaximumSize() |
Если максимальный размер был задан не равным null, просто возвращает его. |
Dimension |
getMinimumSize() |
Если минимальный размер был задан не равным null, просто возвращает его. |
Component |
getNextFocusableComponent() |
Устарело. Начиная с версии 1.4, заменено на FocusTraversalPolicy. |
Point |
getPopupLocation |
Возвращает предпочтительное местоположение для отображения всплывающего меню в системе координат этого компонента. |
Dimension |
getPreferredSize() |
Если свойство preferredSize было установлено в значение, отличное от null, просто возвращает его. |
KeyStroke[] |
getRegisteredKeyStrokes() |
Возвращает KeyStrokes, который будет инициировать зарегистрированные действия. |
JRootPane |
getRootPane() |
Возвращает предка JRootPane для этого компонента. |
Dimension |
getSize |
Сохраняет ширину/высоту этого компонента в "возвращаемое значение" rv и возвращает rv. |
Point |
getToolTipLocation |
Возвращает местоположение всплывающей подсказки в системе координат этого компонента. |
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 |
Возвращает 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 |
Вызывается Swing для отрисовки компонентов. |
protected void |
paintBorder |
Отрисовывает границу компонента. |
protected void |
paintChildren |
Отрисовывает дочерние элементы этого компонента. |
protected void |
paintComponent |
Вызывает метод paint делегата UI, если делегат UI не равен null. |
void |
paintImmediately |
Немедленно перерисовывает указанную область в этом компоненте и всех его потомках, перекрывающих эту область. |
void |
paintImmediately |
Перерисовывает указанную область прямо сейчас. |
void |
print |
Вызовите этот метод для вывода компонента на печать в указанный Graphics. |
void |
printAll |
Вызовите этот метод для вывода компонента на печать. |
protected void |
printBorder |
Выводит на печать границу компонента. |
protected void |
printChildren |
Выводит на печать дочерние элементы этого компонента. |
protected void |
printComponent |
Вызывается во время операции печати. |
protected void |
processComponentKeyEvent |
Обрабатывает любые события клавиатуры, распознаваемые самим компонентом. |
protected boolean |
processKeyBinding |
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e. |
protected void |
processKeyEvent |
Переопределяет processKeyEvent для обработки событий. |
protected void |
processMouseEvent |
Обрабатывает события мыши, происходящие на этом компоненте, путем их диспетчеризации любым зарегистрированным объектам MouseListener; полное описание этого метода см. в Component.processMouseEvent(MouseEvent). |
protected void |
processMouseMotionEvent |
Обрабатывает события движения мыши, такие как MouseEvent.MOUSE_DRAGGED. |
final void |
putClientProperty |
Добавляет произвольное клиентское свойство типа "ключ/значение" к этому компоненту. |
void |
registerKeyboardAction |
Этот метод устарел; используйте комбинацию getActionMap() и getInputMap() для аналогичного поведения. |
void |
registerKeyboardAction |
Этот метод устарел; используйте комбинацию getActionMap() и getInputMap() для аналогичного поведения. |
void |
removeAncestorListener |
Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents. |
void |
removeVetoableChangeListener |
Удаляет VetoableChangeListener из списка слушателей. |
void |
repaint |
Добавляет указанную область в список недействительных (грязных) областей, если компонент отображается. |
void |
repaint |
Добавляет указанную область в список недействительных (грязных) областей, если компонент отображается. |
boolean |
requestDefaultFocus() |
Устарело. Начиная с версии 1.4, заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
|
void |
requestFocus() |
Запрашивает получение фокуса ввода этим Component. |
boolean |
requestFocus |
Запрашивает получение фокуса ввода этим Component. |
boolean |
requestFocusInWindow() |
Запрашивает получение фокуса ввода этим Component. |
protected boolean |
requestFocusInWindow |
Запрашивает получение фокуса ввода этим Component. |
void |
resetKeyboardActions() |
Отменяет все привязки в первом уровне InputMaps и ActionMap. |
void |
reshape |
Устарело. Начиная с версии JDK 5, заменено на Component.setBounds(int, int, int, int). |
void |
revalidate() |
Поддерживает отложенную автоматическую компоновку. |
void |
scrollRectToVisible |
Пересылает сообщение scrollRectToVisible() родителю JComponent. |
final void |
setActionMap |
Устанавливает ActionMap в am. |
void |
setAlignmentX |
Устанавливает выравнивание по горизонтали. |
void |
setAlignmentY |
Устанавливает выравнивание по вертикали. |
void |
setAutoscrolls |
Устанавливает свойство autoscrolls. |
void |
setBackground |
Устанавливает цвет фона этого компонента. |
void |
setBorder |
Устанавливает границу этого компонента. |
void |
setComponentPopupMenu |
Устанавливает JPopupMenu для этого JComponent. |
void |
setDebugGraphicsOptions |
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой внутри компонента или одного из его дочерних элементов. |
static void |
setDefaultLocale |
Устанавливает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании. |
void |
setDoubleBuffered |
Устанавливает, должен ли этот компонент использовать буфер для отрисовки. |
void |
setEnabled |
Устанавливает, включен ли этот компонент. |
void |
setFocusTraversalKeys |
Устанавливает клавиши перемещения фокуса для заданной операции перемещения для этого Component. |
void |
setFont |
Устанавливает шрифт для этого компонента. |
void |
setForeground |
Устанавливает цвет переднего плана этого компонента. |
void |
setInheritsPopupMenu |
Устанавливает, должен ли getComponentPopupMenu делегировать запросы родительскому компоненту, если этому компоненту не назначен JPopupMenu. |
final void |
setInputMap |
Устанавливает InputMap для использования при условии condition в map. |
void |
setInputVerifier |
Устанавливает верификатор ввода для этого компонента. |
void |
setMaximumSize |
Устанавливает максимальный размер этого компонента в константное значение. |
void |
setMinimumSize |
Устанавливает минимальный размер этого компонента в константное значение. |
void |
setNextFocusableComponent |
Устарело. Начиная с версии 1.4, заменено на FocusTraversalPolicy
|
void |
setOpaque |
Если true, компонент отрисовывает каждый пиксель в пределах своих границ. |
void |
setPreferredSize |
Устанавливает предпочтительный размер этого компонента. |
void |
setRequestFocusEnabled |
Дает подсказку относительно того, должен ли этот JComponent получать фокус. |
void |
setToolTipText |
Регистрирует текст для отображения во всплывающей подсказке. |
void |
setTransferHandler |
Устанавливает TransferHandler, который обеспечивает поддержку передачи данных в этот компонент и из него через вырезание/копирование/вставку и перетаскивание (drag and drop). |
protected void |
setUI |
Устанавливает делегат внешнего вида (look and feel) для этого компонента. |
void |
setVerifyInputWhenFocusTarget |
Устанавливает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус. |
void |
setVisible |
Делает компонент видимым или невидимым. |
void |
unregisterKeyboardAction |
Этот метод устарел. |
void |
update |
Вызывает 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 |
add |
Добавляет указанный компонент в этот контейнер в заданную позицию. |
void |
add |
Добавляет указанный компонент в конец этого контейнера. |
void |
add |
Добавляет указанный компонент в этот контейнер с указанными ограничениями по указанному индексу. |
Component |
add |
Добавляет указанный компонент в этот контейнер. |
void |
addContainerListener |
Добавляет указанный слушатель контейнера для получения событий контейнера от этого контейнера. |
protected void |
addImpl |
Добавляет указанный компонент в этот контейнер по указанному индексу. |
void |
addPropertyChangeListener |
Добавляет PropertyChangeListener в список слушателей. |
void |
addPropertyChangeListener |
Добавляет PropertyChangeListener в список слушателей для определенного свойства. |
void |
applyComponentOrientation |
Задает свойство ComponentOrientation этого контейнера и всех содержащихся в нем компонентов. |
boolean |
areFocusTraversalKeysSet |
Возвращает значение, указывающее, был ли явно определен набор клавиш перехода фокуса для заданной операции перехода фокуса для этого Container. |
int |
countComponents() |
Устарело. Начиная с версии JDK 1.1, заменено на getComponentCount(). |
void |
deliverEvent |
Устарело. Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent e)
|
Component |
findComponentAt |
Находит видимый дочерний компонент, содержащий указанную позицию. |
Component |
findComponentAt |
Находит видимый дочерний компонент, содержащий указанную точку. |
Component |
getComponent |
Возвращает n-й компонент в этом контейнере. |
Component |
getComponentAt |
Находит компонент, содержащий позицию x,y. |
Component |
getComponentAt |
Возвращает компонент, содержащий указанную точку. |
int |
getComponentCount() |
Возвращает количество компонентов в этой панели. |
Component[] |
getComponents() |
Возвращает все компоненты в этом контейнере. |
int |
getComponentZOrder |
Возвращает индекс z-порядка компонента внутри контейнера. |
ContainerListener[] |
getContainerListeners() |
Возвращает массив всех слушателей контейнера, зарегистрированных в этом контейнере. |
Set |
getFocusTraversalKeys |
Возвращает набор клавиш перехода фокуса для заданной операции перехода для этого Container. |
FocusTraversalPolicy |
getFocusTraversalPolicy() |
Возвращает политику перехода фокуса, которая будет управлять переходом с клавиатуры по дочерним элементам этого Container, или null, если этот Container не является корнем цикла фокуса. |
LayoutManager |
getLayout() |
Возвращает диспетчер компоновки для этого контейнера. |
Point |
getMousePosition |
Возвращает положение указателя мыши в пространстве координат этого Container, если Container находится под указателем мыши, в противном случае возвращает null. |
Insets |
insets() |
Устарело. Начиная с версии JDK 1.1, заменено на getInsets(). |
void |
invalidate() |
Делает контейнер недействительным. |
boolean |
isAncestorOf |
Проверяет, содержится ли компонент в иерархии компонентов этого контейнера. |
boolean |
isFocusCycleRoot() |
Возвращает значение, указывающее, является ли этот Container корнем цикла перехода фокуса. |
boolean |
isFocusCycleRoot |
Возвращает значение, указывающее, является ли указанный Container корнем цикла перехода фокуса для цикла перехода фокуса этого Container. |
final boolean |
isFocusTraversalPolicyProvider() |
Возвращает значение, указывающее, предоставляет ли этот контейнер политику перехода фокуса. |
boolean |
isFocusTraversalPolicySet() |
Возвращает значение, указывающее, была ли явно установлена политика перехода фокуса для этого Container. |
void |
layout() |
Устарело. Начиная с версии JDK 1.1, заменено на doLayout(). |
void |
list |
Выводит список компонентов этого контейнера в указанный выходной поток. |
void |
list |
Выводит список, начиная с указанного отступа, в указанный print writer. |
Component |
locate |
Устарело. Начиная с версии JDK 1.1, заменено на getComponentAt(int, int). |
Dimension |
minimumSize() |
Устарело. Начиная с версии JDK 1.1, заменено на getMinimumSize(). |
void |
paintComponents |
Отрисовывает каждый из компонентов в этом контейнере. |
Dimension |
preferredSize() |
Устарело. Начиная с версии JDK 1.1, заменено на getPreferredSize(). |
void |
printComponents |
Печатает каждый из компонентов в этом контейнере. |
protected void |
processContainerEvent |
Обрабатывает события контейнера, происходящие в этом контейнере, отправляя их всем зарегистрированным объектам ContainerListener. |
protected void |
processEvent |
Обрабатывает события в этом контейнере. |
void |
remove |
Удаляет компонент, указанный index, из этого контейнера. |
void |
remove |
Удаляет указанный компонент из этого контейнера. |
void |
removeAll() |
Удаляет все компоненты из этого контейнера. |
void |
removeContainerListener |
Удаляет указанный слушатель контейнера, чтобы он больше не получал события контейнера от этого контейнера. |
void |
setComponentZOrder |
Перемещает указанный компонент на указанный индекс z-порядка в контейнере. |
void |
setFocusCycleRoot |
Устанавливает, является ли этот Container корнем цикла перехода фокуса. |
void |
setFocusTraversalPolicy |
Задает политику перехода фокуса, которая будет управлять переходом с клавиатуры по дочерним элементам этого Container, если этот Container является корнем цикла фокуса. |
final void |
setFocusTraversalPolicyProvider |
Устанавливает, будет ли этот контейнер использоваться для предоставления политики перехода фокуса. |
void |
setLayout |
Задает диспетчер компоновки для этого контейнера. |
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 |
Устарело. Начиная с версии JDK 1.1 следует регистрировать этот компонент как ActionListener на компоненте, генерирующем события действия. |
void |
add |
Добавляет указанное всплывающее меню к компоненту. |
void |
addComponentListener |
Добавляет указанный слушатель компонентов для получения событий компонента от этого компонента. |
void |
addFocusListener |
Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода. |
void |
addHierarchyBoundsListener |
Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер. |
void |
addHierarchyListener |
Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер. |
void |
addInputMethodListener |
Добавляет указанный слушатель метода ввода для получения событий метода ввода от этого компонента. |
void |
addKeyListener |
Добавляет указанный слушатель клавиатуры для получения событий клавиш от этого компонента. |
void |
addMouseListener |
Добавляет указанный слушатель мыши для получения событий мыши от этого компонента. |
void |
addMouseMotionListener |
Добавляет указанный слушатель движения мыши для получения событий движения мыши от этого компонента. |
void |
addMouseWheelListener |
Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента. |
Rectangle |
bounds() |
Устарело. Начиная с версии JDK 1.1, заменено на getBounds(). |
int |
checkImage |
Возвращает статус построения экранного представления указанного изображения. |
int |
checkImage |
Возвращает статус построения экранного представления указанного изображения. |
protected AWTEvent |
coalesceEvents |
Потенциально объединяет отправляемое событие с существующим событием. |
boolean |
contains |
Проверяет, "содержит" ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента. |
Image |
createImage |
Создает закадровое отрисовываемое изображение, используемое для двойной буферизации. |
Image |
createImage |
Создает изображение из указанного поставщика изображений. |
VolatileImage |
createVolatileImage |
Создает временное (volatile) закадровое отрисовываемое изображение, используемое для двойной буферизации. |
VolatileImage |
createVolatileImage |
Создает временное (volatile) закадровое отрисовываемое изображение с заданными возможностями. |
protected final void |
disableEvents |
Отключает доставку событий, определенных указанным параметром маски событий, в этот компонент. |
final void |
dispatchEvent |
Диспетчеризирует событие этому компоненту или одному из его подкомпонентов. |
void |
enable |
Устарело. Начиная с версии JDK 1.1, заменено на setEnabled(boolean). |
protected final void |
enableEvents |
Включает доставку событий, определенных указанным параметром маски событий, в этот компонент. |
void |
enableInputMethods |
Включает или отключает поддержку методов ввода для этого компонента. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
void |
firePropertyChange |
Сообщает об изменении связанного свойства. |
protected void |
firePropertyChange |
Поддержка отправки сообщений об изменениях связанных свойств типа 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 |
Возвращает массив всех слушателей, связанных с указанным свойством. |
Dimension |
getSize() |
Возвращает размер этого компонента в виде объекта Dimension. |
Toolkit |
getToolkit() |
Возвращает инструментарий (toolkit) этого компонента. |
final Object |
getTreeLock() |
Возвращает объект блокировки этого компонента (объект, владеющий монитором синхронизации потоков) для операций с деревом компонентов AWT и разметкой. |
boolean |
gotFocus |
Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent). |
boolean |
handleEvent |
Устарело. Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent). |
boolean |
hasFocus() |
Возвращает true, если этот Component является владельцем фокуса. |
boolean |
imageUpdate |
Перерисовывает компонент при изменении изображения. |
boolean |
inside |
Устарело. Начиная с версии 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 |
Устарело. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent). |
boolean |
keyUp |
Устарело. Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent). |
void |
list() |
Выводит список данных этого компонента в стандартный системный поток вывода System.out. |
void |
list |
Выводит список данных этого компонента в указанный поток вывода. |
void |
list |
Выводит список данных в указанный модуль записи (print writer). |
Point |
location() |
Устарело. Начиная с версии JDK 1.1, заменено на getLocation(). |
boolean |
lostFocus |
Устарело. Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent). |
boolean |
mouseDown |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
boolean |
mouseDrag |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent). |
boolean |
mouseEnter |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
boolean |
mouseExit |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
boolean |
mouseMove |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent). |
boolean |
mouseUp |
Устарело. Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent). |
void |
move |
Устарело. Начиная с версии JDK 1.1, заменено на setLocation(int, int). |
void |
nextFocus() |
Устарело. Начиная с версии JDK 1.1, заменено на transferFocus(). |
void |
paintAll |
Отрисовывает этот компонент и все его подкомпоненты. |
boolean |
postEvent |
Устарело. Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent). |
boolean |
prepareImage |
Подготавливает изображение для отрисовки на этом компоненте с указанными шириной и высотой. |
boolean |
prepareImage |
Подготавливает изображение для отрисовки на этом компоненте. |
protected void |
processComponentEvent |
Обрабатывает события компонента, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам ComponentListener. |
protected void |
processFocusEvent |
Обрабатывает события фокуса, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам FocusListener. |
protected void |
processHierarchyBoundsEvent |
Обрабатывает события границ иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам HierarchyBoundsListener. |
protected void |
processHierarchyEvent |
Обрабатывает события иерархии, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам HierarchyListener. |
protected void |
processInputMethodEvent |
Обрабатывает события метода ввода, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам InputMethodListener. |
protected void |
processMouseWheelEvent |
Обрабатывает события колесика мыши, происходящие в этом компоненте, путем их диспетчеризации всем зарегистрированным объектам MouseWheelListener. |
void |
remove |
Удаляет указанное всплывающее меню из компонента. |
void |
removeComponentListener |
Удаляет указанный слушатель компонентов, чтобы он больше не получал события компонента от этого компонента. |
void |
removeFocusListener |
Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента. |
void |
removeHierarchyBoundsListener |
Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента. |
void |
removeHierarchyListener |
Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента. |
void |
removeInputMethodListener |
Удаляет указанный слушатель метода ввода, чтобы он больше не получал события метода ввода от этого компонента. |
void |
removeKeyListener |
Удаляет указанный слушатель клавиатуры, чтобы он больше не получал события клавиш от этого компонента. |
void |
removeMouseListener |
Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента. |
void |
removeMouseMotionListener |
Удаляет указанный слушатель движения мыши, чтобы он больше не получал события движения мыши от этого компонента. |
void |
removeMouseWheelListener |
Удаляет указанный слушатель колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента. |
void |
removePropertyChangeListener |
Удаляет PropertyChangeListener из списка слушателей. |
void |
removePropertyChangeListener |
Удаляет PropertyChangeListener из списка слушателей для определенного свойства. |
void |
repaint() |
Перерисовывает этот компонент. |
void |
repaint |
Перерисовывает указанную прямоугольную область этого компонента. |
void |
repaint |
Перерисовывает компонент. |
protected boolean |
requestFocus |
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, а предок верхнего уровня этого Component стал сфокусированным Window. |
void |
requestFocus |
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, а предок верхнего уровня этого Component стал сфокусированным Window. |
boolean |
requestFocusInWindow |
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, если предок верхнего уровня этого Component уже является сфокусированным Window. |
void |
resize |
Устарело. Начиная с версии JDK 1.1, заменено на setSize(int, int). |
void |
resize |
Устарело. Начиная с версии JDK 1.1, заменено на setSize(Dimension). |
void |
setBounds |
Перемещает этот компонент и изменяет его размер. |
void |
setBounds |
Перемещает этот компонент и изменяет его размер в соответствии с новым ограничивающим прямоугольником r. |
void |
setComponentOrientation |
Устанавливает ориентацию с учетом языка, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента. |
void |
setCursor |
Устанавливает изображение курсора в указанный курсор. |
void |
setDropTarget |
Связывает DropTarget с этим компонентом. |
void |
setFocusable |
Устанавливает состояние фокусируемости этого Component в указанное значение. |
void |
setFocusTraversalKeysEnabled |
Устанавливает, включены ли клавиши обхода фокуса для этого Component. |
void |
setIgnoreRepaint |
Устанавливает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы. |
void |
setLocale |
Устанавливает локаль этого компонента. |
void |
setLocation |
Перемещает этот компонент на новое место. |
void |
setLocation |
Перемещает этот компонент на новое место. |
void |
setMixingCutoutShape |
Задает форму «mixing-cutout» для этого легковесного компонента. |
void |
setName |
Задает имя компонента равным указанной строке. |
void |
setSize |
Изменяет размер этого компонента так, чтобы он имел ширину width и высоту height. |
void |
setSize |
Изменяет размер этого компонента так, чтобы он имел ширину d.width и высоту d.height. |
void |
show() |
Устарело. Начиная с версии JDK 1.1, заменено на setVisible(boolean). |
void |
show |
Устарело. Начиная с версии 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 |
Указывает, равен ли какой-либо другой объект этому объекту. |
protected void |
finalize() |
Устарело, подлежит удалению: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в будущем выпуске. |
final Class |
getClass() |
Возвращает класс времени выполнения данного Object. |
int |
hashCode() |
Возвращает значение хэш-кода для этого объекта. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
final void |
wait() |
Приводит к ожиданию текущего потока до тех пор, пока он не будет разбужен, обычно посредством оповещения или прерывания. |
final void |
wait |
Приводит к ожиданию текущего потока до тех пор, пока он не будет разбужен, обычно посредством оповещения или прерывания, либо пока не истечет определенное количество реального времени. |
final void |
wait |
Приводит к ожиданию текущего потока до тех пор, пока он не будет разбужен, обычно посредством оповещения или прерывания, либо пока не истечет определенное количество реального времени. |
Подробное описание полей
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
cellSelectionEnabled
protected boolean cellSelectionEnabled
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, инициализированный моделью данных по умолчанию, моделью столбцов по умолчанию и моделью выделения по умолчанию.- См. также:
JTable
public JTable(TableModel dm)
JTable, инициализированный с dm в качестве модели данных, моделью столбцов по умолчанию и моделью выделения по умолчанию.- Параметры:
-
dm- модель данных для таблицы - См. также:
JTable
public JTable(TableModel dm, TableColumnModel cm)
JTable, инициализированный с dm в качестве модели данных, cm в качестве модели столбцов и моделью выделения по умолчанию.- Параметры:
-
dm- модель данных для таблицы -
cm- модель столбцов для таблицы - См. также:
JTable
public JTable(TableModel dm, TableColumnModel cm, ListSelectionModel sm)
JTable, инициализированный с dm в качестве модели данных, cm в качестве модели столбцов и sm в качестве модели выделения. Если какой-либо из параметров равен null, этот метод инициализирует таблицу соответствующей моделью по умолчанию. Флаг autoCreateColumnsFromModel устанавливается в false, если cm не равен null; в противном случае устанавливается значение true, и модель столбцов заполняется подходящими объектами TableColumns для столбцов в dm.- Параметры:
-
dm- модель данных для таблицы -
cm- модель столбцов для таблицы -
sm- модель выделения строк для таблицы - См. также:
JTable
public JTable(int numRows, int numColumns)
JTable с numRows и numColumns пустых ячеек с использованием DefaultTableModel. Столбцы будут иметь имена вида "A", "B", "C" и т. д.- Параметры:
-
numRows- количество строк, содержащихся в таблице -
numColumns- количество столбцов, содержащихся в таблице - См. также:
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
protected void configureEnclosingScrollPane()
JTable является viewportView объемлющей панели JScrollPane (обычная ситуация), настраивает этот ScrollPane, помимо прочего, устанавливая tableHeader таблицы в качестве columnHeaderView панели прокрутки. Когда JTable добавляется в JScrollPane обычным способом с помощью new JScrollPane(myTable), метод addNotify вызывается в JTable (когда таблица добавляется в область просмотра). Метод addNotify класса JTable в свою очередь вызывает этот метод, объявленный со спецификатором protected, чтобы эту процедуру установки по умолчанию можно было переопределить в подклассе.- См. также:
removeNotify
public void removeNotify()
unconfigureEnclosingScrollPane.- Переопределяет:
-
removeNotifyв классеJComponent - См. также:
unconfigureEnclosingScrollPane
protected void unconfigureEnclosingScrollPane()
configureEnclosingScrollPane путём замены columnHeaderView объемлющей панели прокрутки на null. Метод removeNotify класса JTable вызывает этот метод, объявленный со спецификатором protected, чтобы эту процедуру удаления по умолчанию можно было переопределить в подклассе.- Начиная с:
- 1.3
- См. также:
createScrollPaneForTable
@Deprecated public static JScrollPane createScrollPaneForTable(JTable aTable)
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
public JTableHeader getTableHeader()
tableHeader, используемый этой таблицей JTable.- Возвращает:
- объект
tableHeader, используемый этой таблицей - См. также:
setRowHeight
@BeanProperty(description="The height of the specified row.") public void setRowHeight(int rowHeight)
rowHeight, выполняет повторную валидацию и перерисовку. Высота ячеек будет равна высоте строки минус отступ строки.- Параметры:
-
rowHeight- новая высота строки - Исключения:
-
IllegalArgumentException- еслиrowHeightменьше 1 - См. также:
getRowHeight
public int getRowHeight()
- Возвращает:
- высоту строки таблицы в пикселях
- См. также:
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
public int getRowMargin()
getIntercellSpacing().height.- Возвращает:
- количество пикселей между ячейками в строке
- См. также:
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
public Dimension getIntercellSpacing()
- Возвращает:
- расстояние между ячейками по горизонтали и вертикали
- См. также:
setGridColor
@BeanProperty(description="The grid color.") public void setGridColor(Color gridColor)
gridColor и перерисовывает таблицу. Цвет по умолчанию зависит от стиля оформления (look and feel).- Параметры:
-
gridColor- новый цвет линий сетки - Исключения:
-
IllegalArgumentException- еслиgridColorравенnull - См. также:
getGridColor
public Color getGridColor()
- Возвращает:
- цвет, используемый для отрисовки линий сетки
- См. также:
setShowGrid
@BeanProperty(description="Whether grid lines are drawn around the cells.") public void setShowGrid(boolean showGrid)
showGrid равен true, линии рисуются; если false — нет. Метода getShowGrid не существует, поскольку это состояние хранится в двух переменных — showHorizontalLines и showVerticalLines, каждую из которых можно запросить независимо.- Параметры:
-
showGrid- значение true, если представление таблицы должно рисовать линии сетки - См. также:
setShowHorizontalLines
@BeanProperty(description="Whether horizontal lines should be drawn in between the cells.") public void setShowHorizontalLines(boolean showHorizontalLines)
showHorizontalLines равен true, линии рисуются; если false — нет.- Параметры:
-
showHorizontalLines- значение true, если представление таблицы должно рисовать горизонтальные линии - См. также:
setShowVerticalLines
@BeanProperty(description="Whether vertical lines should be drawn in between the cells.") public void setShowVerticalLines(boolean showVerticalLines)
showVerticalLines равен true, линии рисуются; если false — нет.- Параметры:
-
showVerticalLines- значение true, если представление таблицы должно рисовать вертикальные линии - См. также:
getShowHorizontalLines
public boolean getShowHorizontalLines()
- Возвращает:
- true, если таблица рисует горизонтальные линии между ячейками, и false, если нет
- См. также:
getShowVerticalLines
public boolean getShowVerticalLines()
- Возвращает:
- true, если таблица рисует вертикальные линии между ячейками, и false, если нет
- См. также:
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
public int getAutoResizeMode()
- Возвращает:
- режим autoResizeMode таблицы
- См. также:
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
public boolean getAutoCreateColumnsFromModel()
setModel очистит все существующие столбцы и создаст новые столбцы из новой модели. Кроме того, если событие в уведомлении tableChanged указывает, что изменилась вся таблица, столбцы будут перестроены. По умолчанию равно true.- Возвращает:
- значение autoCreateColumnsFromModel таблицы
- См. также:
createDefaultColumnsFromModel
public void createDefaultColumnsFromModel()
getColumnCount, определённого в интерфейсе TableModel. Очищает все существующие столбцы перед созданием новых столбцов на основе информации из модели.
- См. также:
setDefaultRenderer
public void setDefaultRenderer(Class<?> columnClass, TableCellRenderer renderer)
TableColumn. Если визуализатор равен null, удаляет визуализатор по умолчанию для этого класса столбца.- Параметры:
-
columnClass- задает визуализатор ячеек по умолчанию для этого columnClass -
renderer- визуализатор ячеек по умолчанию, используемый для этого columnClass - См. также:
getDefaultRenderer
public TableCellRenderer getDefaultRenderer(Class<?> columnClass)
TableColumn. Во время отрисовки ячеек визуализатор извлекается из Hashtable записей в соответствии с классом ячеек в столбце. Если для этого columnClass запись отсутствует, метод возвращает запись для наиболее специфичного суперкласса. JTable устанавливает записи для Object, Number и Boolean, каждую из которых можно изменить или заменить.- Параметры:
-
columnClass- возвращает визуализатор ячеек по умолчанию для этого columnClass - Возвращает:
- визуализатор для этого columnClass
- См. также:
setDefaultEditor
public void setDefaultEditor(Class<?> columnClass, TableCellEditor editor)
TableColumn. Если редактирование в таблице или определенном столбце таблицы не требуется, используйте метод isCellEditable в интерфейсе TableModel, чтобы гарантировать, что этот JTable не запустит редактор в этих столбцах. Если редактор равен null, удаляет редактор по умолчанию для этого класса столбца.- Параметры:
-
columnClass- задает редактор ячеек по умолчанию для этого columnClass -
editor- редактор ячеек по умолчанию, используемый для этого columnClass - См. также:
getDefaultEditor
public TableCellEditor getDefaultEditor(Class<?> columnClass)
TableColumn. Во время редактирования ячеек редактор извлекается из Hashtable записей в соответствии с классом ячеек в столбце. Если для этого columnClass запись отсутствует, метод возвращает запись для наиболее специфичного суперкласса. JTable устанавливает записи для Object, Number и Boolean, каждую из которых можно изменить или заменить.- Параметры:
-
columnClass- возвращает редактор ячеек по умолчанию для этого columnClass - Возвращает:
- редактор ячеек по умолчанию, используемый для этого columnClass
- См. также:
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
- См. также:
getDragEnabled
public boolean getDragEnabled()
- Возвращает:
- значение свойства
dragEnabled - С версии:
- 1.4
- См. также:
setDropMode
public final void setDropMode(DropMode dropMode)
DropMode.USE_SELECTION. Однако для улучшения пользовательского интерфейса рекомендуется использовать один из других режимов. Например, DropMode.ON предлагает аналогичное поведение с отображением элементов как выбранных, но делает это без изменения фактического выделения в таблице. JTable поддерживает следующие режимы сброса:
DropMode.USE_SELECTIONDropMode.ONDropMode.INSERTDropMode.INSERT_ROWSDropMode.INSERT_COLSDropMode.ON_OR_INSERTDropMode.ON_OR_INSERT_ROWSDropMode.ON_OR_INSERT_COLS
Режим сброса имеет смысл только в том случае, если этот компонент имеет TransferHandler, принимающий сбросы.
- Параметры:
-
dropMode- используемый режим сброса - Исключения:
-
IllegalArgumentException- если режим сброса не поддерживается или равенnull - С версии:
- 1.6
- См. также:
getDropMode
public final DropMode getDropMode()
- Возвращает:
- режим сброса для этого компонента
- С версии:
- 1.6
- См. также:
getDropLocation
@BeanProperty(bound=false) public final JTable.DropLocation getDropLocation()
null, если в данный момент местоположение не должно отображаться. Этот метод не предназначен для запроса места сброса из TransferHandler, так как место сброса устанавливается только после того, как метод canImport у TransferHandler вернул значение и разрешил отображение местоположения.
При изменении этого свойства компонент генерирует событие изменения свойства с именем «dropLocation».
- Возвращает:
- местоположение сброса
- С версии:
- 1.6
- См. также:
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
- См. также:
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)
- Параметры:
-
update- обновлять ли выделение при сортировке - С версии:
- 1.6
getUpdateSelectionOnSort
public boolean getUpdateSelectionOnSort()
- Возвращает:
- следует ли обновлять выделение при сортировке
- С версии:
- 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
- См. также:
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- режим, используемый моделями выделения строк и столбцов - См. также:
setRowSelectionAllowed
@BeanProperty(visualUpdate=true, description="If true, an entire row is selected for each selected cell.") public void setRowSelectionAllowed(boolean rowSelectionAllowed)
- Параметры:
-
rowSelectionAllowed- true, если эта модель разрешает выделение строк - См. также:
getRowSelectionAllowed
public boolean getRowSelectionAllowed()
- Возвращает:
- true, если строки могут быть выделены; в противном случае — false
- См. также:
setColumnSelectionAllowed
@BeanProperty(visualUpdate=true, description="If true, an entire column is selected for each selected cell.") public void setColumnSelectionAllowed(boolean columnSelectionAllowed)
- Параметры:
-
columnSelectionAllowed- true, если эта модель разрешает выделение столбцов - См. также:
getColumnSelectionAllowed
public boolean getColumnSelectionAllowed()
- Возвращает:
- true, если столбцы могут быть выделены; в противном случае — false
- См. также:
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
public boolean getCellSelectionEnabled()
getRowSelectionAllowed() &&
getColumnSelectionAllowed().- Возвращает:
- true, если включены обе модели выделения строк и столбцов
- См. также:
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()
- Возвращает:
- индекс первой выделенной строки
getSelectedColumn
@BeanProperty(bound=false) public int getSelectedColumn()
- Возвращает:
- индекс первого выделенного столбца
getSelectedRows
@BeanProperty(bound=false) public int[] getSelectedRows()
- Возвращает:
- массив целых чисел, содержащий индексы всех выделенных строк, или пустой массив, если ни одна строка не выделена
- См. также:
getSelectedColumns
@BeanProperty(bound=false) public int[] getSelectedColumns()
- Возвращает:
- массив целых чисел, содержащий индексы всех выделенных столбцов, или пустой массив, если ни один столбец не выделен
- См. также:
getSelectedRowCount
@BeanProperty(bound=false) public int getSelectedRowCount()
- Возвращает:
- количество выделенных строк, 0, если ни одна строка не выделена
getSelectedColumnCount
@BeanProperty(bound=false) public int getSelectedColumnCount()
- Возвращает:
- количество выделенных столбцов, 0, если ни один столбец не выделен
isRowSelected
public boolean isRowSelected(int row)
- Параметры:
-
row- строка в модели строк - Возвращает:
- true, если
rowявляется допустимым индексом и строка с этим индексом выделена (где 0 — первая строка)
isColumnSelected
public boolean isColumnSelected(int column)
- Параметры:
-
column- столбец в модели столбцов - Возвращает:
- true, если
columnявляется допустимым индексом и столбец с этим индексом выделен (где 0 — первый столбец)
isCellSelected
public boolean isCellSelected(int row, int column)
- Параметры:
-
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
@BeanProperty(description="A default foreground color for selected cells.") public void setSelectionForeground(Color selectionForeground)
Значение по умолчанию для этого свойства определяется реализацией внешнего вида.
Это связанное свойство JavaBeans.
- Параметры:
-
selectionForeground-Colorдля использования в качестве цвета переднего плана для выделенных элементов списка - См. также:
getSelectionBackground
public Color getSelectionBackground()
- Возвращает:
Color, используемый для фона выделенных элементов списка- См. также:
setSelectionBackground
@BeanProperty(description="A default background color for selected cells.") public void setSelectionBackground(Color selectionBackground)
Значение этого свойства по умолчанию определяется реализацией внешнего вида и функциональности (look and feel).
Это связанное свойство JavaBeans.
- Параметры:
-
selectionBackground-Colorдля использования в качестве фона выделенных ячеек - См. также:
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
public int convertColumnIndexToView(int modelColumnIndex)
modelColumnIndex с индексом столбца в представлении. Возвращает индекс соответствующего столбца в представлении; возвращает -1, если этот столбец не отображается. Если modelColumnIndex меньше нуля, возвращает modelColumnIndex.- Параметры:
-
modelColumnIndex- индекс столбца в модели - Возвращает:
- индекс соответствующего столбца в представлении
- См. также:
convertRowIndexToView
public int convertRowIndexToView(int modelRowIndex)
TableModel с представлением. Если содержимое модели не отсортировано, индексы модели и представления совпадают.- Параметры:
-
modelRowIndex- индекс строки в терминах модели - Возвращает:
- индекс соответствующей строки в представлении или -1, если строка не видна
- Исключения:
-
IndexOutOfBoundsException- если включена сортировка и передан индекс, выходящий за пределы количества строкTableModel - Начиная с версии:
- 1.6
- См. также:
convertRowIndexToModel
public int convertRowIndexToModel(int viewRowIndex)
TableModel. Если содержимое модели не отсортировано, индексы модели и представления совпадают.- Параметры:
-
viewRowIndex- индекс строки в представлении - Возвращает:
- индекс соответствующей строки в модели
- Исключения:
-
IndexOutOfBoundsException- если включена сортировка и передан индекс за пределами диапазонаJTable, определенного методомgetRowCount - Начиная с версии:
- 1.6
- См. также:
getRowCount
@BeanProperty(bound=false) public int getRowCount()
JTable при неограниченном пространстве. Если был указан RowSorter с фильтром, возвращаемое количество строк может отличаться от количества строк в базовой TableModel.- Возвращает:
- количество строк, отображаемых в
JTable - См. также:
getColumnCount
@BeanProperty(bound=false) public int getColumnCount()
- Возвращает:
- количество столбцов в таблице
- См. также:
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- столбец изменяемой ячейки - См. также:
isCellEditable
public boolean isCellEditable(int row, int column)
row и column доступна для редактирования. В противном случае вызов setValueAt для ячейки не возымеет эффекта. Примечание: столбец указывается в порядке отображения в представлении таблицы, а не в порядке столбцов TableModel. Это важное различие, поскольку по мере того как пользователь переупорядочивает столбцы в таблице, столбец с данным индексом в представлении будет меняться. При этом действия пользователя никогда не влияют на порядок столбцов в модели.
- Параметры:
-
row- строка, значение которой запрашивается -
column- столбец, значение которого запрашивается - Возвращает:
- true, если ячейка доступна для редактирования
- См. также:
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
public void removeColumn(TableColumn aColumn)
aColumn из массива столбцов этого JTable. Примечание: этот метод не удаляет столбец данных из модели; он лишь удаляет TableColumn, отвечавший за его отображение.- Параметры:
-
aColumn- удаляемый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
public int rowAtPoint(Point point)
point, или -1, если результат не находится в диапазоне [0, getRowCount()-1].- Параметры:
-
point- интересующая точка - Возвращает:
- индекс строки, в которой находится
point, или -1, если результат не находится в диапазоне [0,getRowCount()-1] - См. также:
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 - См. также:
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], алгоритм устанавливает для всех размеров их соответствующие предельные значения (максимум или минимум).
sizeColumnsToFit
@Deprecated public void sizeColumnsToFit(boolean lastColumnOnly)
doLayout().- Параметры:
-
lastColumnOnly- определяет, следует ли изменять размер только последнего столбца - См. также:
sizeColumnsToFit
public void sizeColumnsToFit(int resizingColumn)
doLayout().- Параметры:
-
resizingColumn- столбец, изменение размера которого вызвало необходимость этой корректировки, или -1, если такого столбца нет - См. также:
getToolTipText
public String getToolTipText(MouseEvent event)
getToolTipText класса JComponent, чтобы разрешить использование подсказок средства визуализации (рендерера), если в нем задан текст. Примечание: для того чтобы JTable правильно отображал всплывающие подсказки своих рендереров, JTable должен быть зарегистрированным компонентом в ToolTipManager. Это выполняется автоматически в initializeLocalVars, но если позже для JTable будет вызван setToolTipText(null), компонент таблицы будет разрегистрирован, и подсказки от рендереров больше отображаться не будут.
- Переопределяет:
-
getToolTipTextв классеJComponent - Параметры:
-
event- событиеMouseEvent, инициировавшее отображениеToolTip - Возвращает:
- строка, содержащая всплывающую подсказку
- См. также:
setSurrendersFocusOnKeystroke
public void setSurrendersFocusOnKeystroke(boolean surrendersFocusOnKeystroke)
- Параметры:
-
surrendersFocusOnKeystroke- true, если редактор должен получать фокус, когда нажатия клавиш приводят к активации редактора - Начиная с версии:
- 1.4
- См. также:
getSurrendersFocusOnKeystroke
public boolean getSurrendersFocusOnKeystroke()
- Возвращает:
- true, если редактор должен получать фокус, когда нажатия клавиш приводят к активации редактора
- Начиная с версии:
- 1.4
- См. также:
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, если таблица редактирует ячейку
- См. также:
getEditorComponent
@BeanProperty(bound=false) public Component getEditorComponent()
- Возвращает:
- компонент, обрабатывающий сеанс редактирования
getEditingColumn
public int getEditingColumn()
- Возвращает:
- индекс столбца, содержащего ячейку, которая в данный момент редактируется; возвращает -1, если ничего не редактируется
- См. также:
getEditingRow
public int getEditingRow()
- Возвращает:
- индекс строки, содержащей редактируемую в данный момент ячейку; возвращает -1, если ничего не редактируется
- См. также:
getUI
public TableUI getUI()
- Переопределяет:
-
getUIв классеJComponent - Возвращает:
- объект
TableUI, отрисовывающий этот компонент
setUI
@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(TableUI ui)
- Параметры:
-
ui- объект L&F TableUI - См. также:
updateUI
public void updateUI()
UIManager об изменении L&F. Заменяет текущий объект UI на последнюю версию из UIManager.- Переопределяет:
-
updateUIв классеJComponent - См. также:
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
- Переопределяет:
-
getUIClassIDв классеJComponent - Возвращает:
- строку "TableUI"
- См. также:
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
public TableModel getModel()
TableModel, предоставляющую данные, отображаемые этим JTable.- Возвращает:
TableModel, предоставляющую данные, отображаемые этимJTable- См. также:
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
public TableColumnModel getColumnModel()
TableColumnModel, содержащую всю информацию о столбцах этой таблицы.- Возвращает:
- объект, предоставляющий состояние столбцов таблицы
- См. также:
setSelectionModel
@BeanProperty(description="The selection model for rows.") public void setSelectionModel(ListSelectionModel selectionModel)
selectionModel и регистрируется для получения уведомлений слушателей от новой модели выделения.- Параметры:
-
selectionModel- новая модель выделения - Выбрасывает:
-
IllegalArgumentException- еслиselectionModelимеет значениеnull - См. также:
getSelectionModel
public ListSelectionModel getSelectionModel()
ListSelectionModel, используемую для поддержания состояния выделения строк.- Возвращает:
- объект, предоставляющий состояние выделения строк;
null, если выделение строк не разрешено - См. также:
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 - См. также:
columnRemoved
public void columnRemoved(TableColumnModelEvent e)
Код приложения не будет использовать эти методы явно, они используются внутри JTable.
- Указано в:
-
columnRemovedв интерфейсеTableColumnModelListener - Параметры:
-
e-TableColumnModelEvent - См. также:
columnMoved
public void columnMoved(TableColumnModelEvent e)
Код приложения не будет использовать эти методы явно, они используются внутри JTable.
- Указано в:
-
columnMovedв интерфейсеTableColumnModelListener - Параметры:
-
e- полученное событие - См. также:
columnMarginChanged
public void columnMarginChanged(ChangeEvent e)
Код приложения не будет использовать эти методы явно, они используются внутри JTable.
- Указано в:
-
columnMarginChangedв интерфейсеTableColumnModelListener - Параметры:
-
e- полученное событие - См. также:
columnSelectionChanged
public void columnSelectionChanged(ListSelectionEvent e)
TableColumnModel. Код приложения не будет использовать эти методы явно, они используются внутри JTable.
- Указано в:
-
columnSelectionChangedв интерфейсеTableColumnModelListener - Параметры:
-
e- полученное событие - См. также:
valueChanged
public void valueChanged(ListSelectionEvent e)
Код приложения не будет использовать эти методы явно, они используются внутри JTable.
- Указано в:
-
valueChangedв интерфейсеListSelectionListener - Параметры:
-
e- полученное событие - См. также:
editingStopped
public void editingStopped(ChangeEvent e)
Код приложения не будет использовать эти методы явно, они используются внутри JTable.
- Указано в:
-
editingStoppedв интерфейсеCellEditorListener - Параметры:
-
e- полученное событие - См. также:
editingCanceled
public void editingCanceled(ChangeEvent e)
Код приложения не будет использовать эти методы явно, они используются внутри JTable.
- Указано в:
-
editingCanceledв интерфейсеCellEditorListener - Параметры:
-
e- полученное событие - См. также:
setPreferredScrollableViewportSize
@BeanProperty(bound=false, description="The preferred size of the viewport.") public void setPreferredScrollableViewportSize(Dimension size)
- Параметры:
-
size- объектDimension, задающийpreferredSizeдляJViewport, представлением которого является эта таблица - См. также:
getPreferredScrollableViewportSize
public Dimension getPreferredScrollableViewportSize()
- Указано в:
-
getPreferredScrollableViewportSizeв интерфейсеScrollable - Возвращает:
- объект
Dimension, содержащийpreferredSizeдляJViewport, отображающего эту таблицу - См. также:
getScrollableUnitIncrement
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Этот метод вызывается каждый раз, когда пользователь запрашивает единичную прокрутку.
- Указано в:
-
getScrollableUnitIncrementв интерфейсеScrollable - Параметры:
-
visibleRect- видимая область представления в пределах viewport -
orientation- либоSwingConstants.VERTICAL, либоSwingConstants.HORIZONTAL -
direction- меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо - Возвращает:
- «единичный» шаг для прокрутки в указанном направлении
- См. также:
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в соответствии с ориентацией - См. также:
getScrollableTracksViewportWidth
@BeanProperty(bound=false) public boolean getScrollableTracksViewportWidth()
autoResizeMode установлено в AUTO_RESIZE_OFF, что указывает на то, что ширина области просмотра не определяет ширину таблицы. В противном случае возвращает true.- Указано в:
-
getScrollableTracksViewportWidthв интерфейсеScrollable - Возвращает:
- false, если
autoResizeModeустановлено вAUTO_RESIZE_OFF, в противном случае возвращает true - См. также:
getScrollableTracksViewportHeight
@BeanProperty(bound=false) public boolean getScrollableTracksViewportHeight()
false, указывая, что высота области просмотра не определяет высоту таблицы, если только getFillsViewportHeight не равно true и предпочтительная высота таблицы не меньше высоты области просмотра.- Указано в:
-
getScrollableTracksViewportHeightв интерфейсеScrollable - Возвращает:
-
false, если толькоgetFillsViewportHeightне равноtrueи таблицу не требуется растянуть для заполнения области просмотра - См. также:
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
public boolean getFillsViewportHeight()
- Возвращает:
- делается ли эта таблица всегда достаточно большой, чтобы заполнить высоту объемлющей области просмотра
- С версии:
- 1.6
- См. также:
createDefaultRenderers
protected void createDefaultRenderers()
- См. также:
createDefaultEditors
protected void createDefaultEditors()
- См. также:
initializeLocalVars
protected void initializeLocalVars()
createDefaultDataModel
protected TableModel createDefaultDataModel()
DefaultTableModel. Подкласс может переопределить этот метод для возврата другого объекта модели таблицы.- Возвращает:
- объект модели таблицы по умолчанию
- См. также:
createDefaultColumnModel
protected TableColumnModel createDefaultColumnModel()
DefaultTableColumnModel. Подкласс может переопределить этот метод для возврата другого объекта модели столбцов.- Возвращает:
- объект модели столбцов по умолчанию
- См. также:
createDefaultSelectionModel
protected ListSelectionModel createDefaultSelectionModel()
DefaultListSelectionModel. Подкласс может переопределить этот метод для возврата другого объекта модели выделения.- Возвращает:
- объект модели выделения по умолчанию
- См. также:
createDefaultTableHeader
protected JTableHeader createDefaultTableHeader()
JTableHeader. Подкласс может переопределить этот метод для возврата другого объекта заголовка таблицы.- Возвращает:
- объект заголовка таблицы по умолчанию
- См. также:
resizeAndRepaint
protected void resizeAndRepaint()
revalidate, за которым следует repaint.getCellEditor
public TableCellEditor getCellEditor()
null, если в данный момент таблица не редактируется.- Возвращает:
TableCellEditor, выполняющий редактирование, илиnull, если в данный момент таблица не редактируется.- См. также:
setCellEditor
@BeanProperty(description="The table's active cell editor.") public void setCellEditor(TableCellEditor anEditor)
- Параметры:
-
anEditor- активный редактор ячейки - См. также:
setEditingColumn
public void setEditingColumn(int aColumn)
editingColumn.- Параметры:
-
aColumn- столбец редактируемой ячейки - См. также:
setEditingRow
public void setEditingRow(int aRow)
editingRow.- Параметры:
-
aRow- строка редактируемой ячейки - См. также:
getCellRenderer
public TableCellRenderer getCellRenderer(int row, int column)
TableColumn для этого столбца имеет ненулевой рендерер, возвращает его. В противном случае находит класс данных в этом столбце (с помощью getColumnClass) и возвращает рендерер по умолчанию для этого типа данных. Примечание. Во всем пакете таблиц внутренние реализации всегда используют этот метод для предоставления рендереров, чтобы это поведение по умолчанию можно было безопасно переопределить в подклассе.
- Параметры:
-
row- строка отрисовываемой ячейки, где 0 — первая строка -
column- столбец отрисовываемой ячейки, где 0 — первый столбец - Возвращает:
- назначенный рендерер; если
null, возвращает рендерер по умолчанию для этого типа объекта - См. также:
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, возвращает редактор по умолчанию для этого типа ячейки - См. также:
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 - Возвращает:
- строковое представление этой таблицы
public boolean print() throws PrinterException
JTable в режиме PrintMode.FIT_WIDTH, без текста верхнего или нижнего колонтитула. На время печати будет отображаться модальное диалоговое окно хода выполнения с возможностью отмены. Примечание: В headless-режиме диалоговые окна не отображаются, и печать выполняется на принтере по умолчанию.
- Возвращает:
- true, если только печать не была отменена пользователем
- Исключения:
-
PrinterException- если ошибка в системе печати приводит к прерыванию задания - С какого года:
- 1.5
- См. также:
public boolean print(JTable.PrintMode printMode) throws PrinterException
JTable в заданном режиме печати, без текста верхнего или нижнего колонтитула. На время печати будет отображаться модальное диалоговое окно хода выполнения с возможностью отмены. Примечание: В headless-режиме диалоговые окна не отображаются, и печать выполняется на принтере по умолчанию.
- Параметры:
-
printMode- режим печати, который должен использовать печатный объект - Возвращает:
- true, если только печать не была отменена пользователем
- Исключения:
-
PrinterException- если ошибка в системе печати приводит к прерыванию задания - С какого года:
- 1.5
- См. также:
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
- См. также:
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
- См. также:
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
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
- См. также:
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
- Указано в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеComponent - Возвращает:
- AccessibleJTable, который служит в качестве AccessibleContext этой JTable
© 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.
new JScrollPane(aTable).