Класс JTableHeader
- Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, EventListener, Accessible, TableColumnModelListener
public class JTableHeader extends JComponent implements TableColumnModelListener, Accessible
JTable. Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class |
JTableHeader.AccessibleJTableHeader |
Этот класс реализует поддержку специальных возможностей для класса JTableHeader. |
Вложенные классы и интерфейсы, объявленные в классе JComponent
JComponent.AccessibleJComponent
Вложенные классы и интерфейсы, объявленные в классе Container
Container.AccessibleAWTContainer
Вложенные классы и интерфейсы, объявленные в классе Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected TableColumnModel |
columnModel |
TableColumnModel таблицы. |
protected TableColumn |
draggedColumn |
Индекс перетаскиваемого столбца. |
protected int |
draggedDistance |
Расстояние, на которое столбец перемещен относительно исходного положения. |
protected boolean |
reorderingAllowed |
Если значение равно true, пользователь может менять порядок столбцов; по умолчанию — true. |
protected boolean |
resizingAllowed |
Если значение равно true, пользователь может изменять размер столбцов; по умолчанию — true. |
protected TableColumn |
resizingColumn |
Индекс изменяемого по размеру столбца. |
protected JTable |
table |
Таблица, заголовком которой является этот объект; по умолчанию — null. |
protected boolean |
updateTableInRealTime |
Устарело начиная с платформы Java 2 версии 1.3. |
Поля, объявленные в классе JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Поля, объявленные в классе Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Поля, объявленные в интерфейсе ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
JTableHeader() |
Создает JTableHeader со значением TableColumnModel по умолчанию. |
JTableHeader |
Создает JTableHeader, инициализированный с cm в качестве модели столбцов. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
columnAdded |
Вызывается при добавлении столбца в модель столбцов таблицы. |
int |
columnAtPoint |
Возвращает индекс столбца, в котором находится point, или -1, если он находится за пределами таблицы. |
void |
columnMarginChanged |
Вызывается при перемещении столбца вследствие изменения отступа. |
void |
columnMoved |
Вызывается при изменении положения столбца. |
void |
columnRemoved |
Вызывается при удалении столбца из модели столбцов таблицы. |
void |
columnSelectionChanged |
Вызывается при изменении модели выбора для TableColumnModel. |
protected TableColumnModel |
createDefaultColumnModel() |
Возвращает объект модели столбцов по умолчанию, который является DefaultTableColumnModel. |
protected TableCellRenderer |
createDefaultRenderer() |
Возвращает визуализатор по умолчанию, используемый, если TableColumn не задает визуализатор заголовка. |
AccessibleContext |
getAccessibleContext() |
Получает AccessibleContext, связанный с этим JTableHeader. |
TableColumnModel |
getColumnModel() |
Возвращает TableColumnModel, содержащую сведения обо всех столбцах этого заголовка таблицы. |
TableCellRenderer |
getDefaultRenderer() |
Возвращает визуализатор по умолчанию, используемый, если headerRenderer не задан в TableColumn. |
TableColumn |
getDraggedColumn() |
Возвращает перетаскиваемый столбец, только если выполняется перетаскивание; в противном случае возвращает null. |
int |
getDraggedDistance() |
Возвращает горизонтальное расстояние столбца от исходного положения, только если выполняется перетаскивание. |
Rectangle |
getHeaderRect |
Возвращает прямоугольник, содержащий ячейку заголовка в позиции column. |
Dimension |
getPreferredSize() |
Возвращает предпочтительный размер заголовка таблицы. |
boolean |
getReorderingAllowed() |
Возвращает true, если пользователь может менять порядок столбцов, перетаскивая их заголовки, и false в противном случае. |
boolean |
getResizingAllowed() |
Возвращает true, если пользователь может изменять размер столбцов, перетаскивая границы между их заголовками, и false в противном случае. |
TableColumn |
getResizingColumn() |
Возвращает изменяемый по размеру столбец. |
JTable |
getTable() |
Возвращает таблицу, связанную с этим заголовком. |
String |
getToolTipText |
Позволяет использовать подсказки визуализатора, если задан текст. |
TableHeaderUI |
getUI() |
Возвращает объект оформления (L&F), который отображает этот компонент. |
String |
getUIClassID() |
Возвращает суффикс, используемый для формирования имени класса оформления (L&F), применяемого для отображения этого компонента. |
boolean |
getUpdateTableInRealTime() |
Устарело начиная с платформы Java 2 версии 1.3. |
protected void |
initializeLocalVars() |
Инициализирует локальные переменные и свойства значениями по умолчанию. |
protected String |
paramString() |
Возвращает строковое представление этого JTableHeader. |
void |
resizeAndRepaint() |
Задает размер заголовка и помечает его как требующий отображения. |
void |
setColumnModel |
Задает для этой таблицы модель столбцов newModel и регистрирует обработчики для получения уведомлений от новой модели столбцов. |
void |
setDefaultRenderer |
Задает визуализатор по умолчанию, используемый, если headerRenderer не задан в TableColumn. |
void |
setDraggedColumn |
Задает draggedColumn заголовка равным aColumn. |
void |
setDraggedDistance |
Задает draggedDistance заголовка равным distance. |
void |
setReorderingAllowed |
Задает, может ли пользователь перетаскивать заголовки столбцов, чтобы менять порядок столбцов. |
void |
setResizingAllowed |
Задает, может ли пользователь изменять размер столбцов, перетаскивая границы между заголовками. |
void |
setResizingColumn |
Задает resizingColumn заголовка равным aColumn. |
void |
setTable |
Задает таблицу, связанную с этим заголовком. |
void |
setUI |
Задает объект оформления (L&F), который отображает этот компонент. |
void |
setUpdateTableInRealTime |
Устарело начиная с платформы Java 2 версии 1.3. |
void |
updateUI() |
Уведомление от UIManager об изменении оформления (L&F). |
Методы, объявленные в классе JComponent
addAncestorListener, addNotify, 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, 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, removeNotify, 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
Методы, объявленные в классе Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, 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
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
Подробное описание полей
table
protected JTable table
null.columnModel
protected TableColumnModel columnModel
TableColumnModel заголовка таблицы.reorderingAllowed
protected boolean reorderingAllowed
resizingAllowed
protected boolean resizingAllowed
updateTableInRealTime
protected boolean updateTableInRealTime
resizingColumn
protected transient TableColumn resizingColumn
null, если изменение размера не выполняется.draggedColumn
protected transient TableColumn draggedColumn
null, если перетаскивание не выполняется.draggedDistance
protected transient int draggedDistance
Подробное описание конструкторов
JTableHeader
public JTableHeader()
JTableHeader со значением TableColumnModel по умолчанию.- См. также:
JTableHeader
public JTableHeader(TableColumnModel cm)
JTableHeader, инициализированный значением cm в качестве модели столбцов. Если cm равно null, этот метод инициализирует заголовок таблицы значением TableColumnModel по умолчанию.- Параметры:
-
cm— модель столбцов таблицы - См. также:
Подробное описание методов
setTable
@BeanProperty(description="The table associated with this header.") public void setTable(JTable table)
- Параметры:
-
table— новая таблица
getTable
public JTable getTable()
- Возвращает:
- свойство
table
setReorderingAllowed
@BeanProperty(description="Whether the user can drag column headers to reorder columns.") public void setReorderingAllowed(boolean reorderingAllowed)
- Параметры:
-
reorderingAllowed— true, если представление таблицы должно разрешать изменение порядка; в противном случае — false - См. также:
getReorderingAllowed
public boolean getReorderingAllowed()
- Возвращает:
- свойство
reorderingAllowed - См. также:
setResizingAllowed
@BeanProperty(description="Whether the user can resize columns by dragging between headers.") public void setResizingAllowed(boolean resizingAllowed)
- Параметры:
-
resizingAllowed— true, если представление таблицы должно разрешать изменение размера - См. также:
getResizingAllowed
public boolean getResizingAllowed()
- Возвращает:
- свойство
resizingAllowed - См. также:
getDraggedColumn
public TableColumn getDraggedColumn()
null.- Возвращает:
- перетаскиваемый столбец, если в данный момент выполняется перетаскивание; в противном случае возвращает
null - См. также:
getDraggedDistance
public int getDraggedDistance()
- Возвращает:
- горизонтальное расстояние от исходного положения столбца, если в данный момент выполняется перетаскивание; в противном случае возвращаемое значение не имеет смысла
- См. также:
getResizingColumn
public TableColumn getResizingColumn()
null.- Возвращает:
- изменяемый столбец, если изменение размера выполняется; в противном случае возвращает
null
setUpdateTableInRealTime
public void setUpdateTableInRealTime(boolean flag)
- Параметры:
-
flag— true, если tableView должна обновлять содержимое таблицы в реальном времени
getUpdateTableInRealTime
public boolean getUpdateTableInRealTime()
- Возвращает:
- true, если таблица обновляется в реальном времени
setDefaultRenderer
public void setDefaultRenderer(TableCellRenderer defaultRenderer)
TableColumn не определён headerRenderer.- Параметры:
-
defaultRenderer— визуализатор по умолчанию - Начиная с версии:
- 1.3
getDefaultRenderer
public TableCellRenderer getDefaultRenderer()
TableColumn не определён headerRenderer.- Возвращает:
- визуализатор по умолчанию
- Начиная с версии:
- 1.3
columnAtPoint
public int columnAtPoint(Point point)
point, или -1, если он находится за пределами таблицы.- Параметры:
-
point— если этотpointнаходится внутри столбца, будет возвращён индекс этого столбца; в противном случае он находится за пределами таблицы, и возвращается -1 - Возвращает:
- индекс столбца, в котором находится
point, или -1, если он находится за пределами таблицы
getHeaderRect
public Rectangle getHeaderRect(int column)
column. Если параметр column выходит за допустимые границы, этот метод использует те же правила, что и метод JTable getCellRect.- Параметры:
-
column— индекс столбца - Возвращает:
- прямоугольник, содержащий ячейку заголовка в позиции
column - См. также:
getToolTipText
public String getToolTipText(MouseEvent event)
- Переопределяет:
-
getToolTipTextв классеJComponent - Параметры:
-
event— положение события определяет соответствующий визуализатор и, следовательно, соответствующую подсказку - Возвращает:
- всплывающую подсказку для этого компонента
getPreferredSize
public Dimension getPreferredSize()
Dimension width всегда вычисляется лежащим в основе TableHeaderUI независимо от ширины, заданной с помощью JComponent.setPreferredSize(java.awt.Dimension)
- Переопределяет:
-
getPreferredSizeв классеJComponent - Возвращает:
- размер
- См. также:
getUI
public TableHeaderUI getUI()
- Переопределяет:
-
getUIв классеJComponent - Возвращает:
- объект
TableHeaderUI, который отображает этот компонент
setUI
public void setUI(TableHeaderUI ui)
- Параметры:
-
ui— объект оформления L&FTableHeaderUI - См. также:
updateUI
public void updateUI()
UIManager об изменении оформления (L&F). Заменяет текущий объект UI последней версией из UIManager.- Переопределяет:
-
updateUIв классеJComponent - См. также:
getUIClassID
public String getUIClassID()
- Переопределяет:
-
getUIClassIDв классеJComponent - Возвращает:
- строку "TableHeaderUI"
- См. также:
setColumnModel
@BeanProperty(description="The object governing the way columns appear in the view.") public void setColumnModel(TableColumnModel columnModel)
newModel и регистрирует обработчик для получения уведомлений от новой модели столбцов.- Параметры:
-
columnModel— новый источник данных для этой таблицы - Вызывает исключение:
-
IllegalArgumentException— еслиnewModelравноnull - См. также:
getColumnModel
public TableColumnModel getColumnModel()
TableColumnModel, содержащую все сведения о столбцах этого заголовка таблицы.- Возвращает:
- свойство
columnModel - См. также:
columnAdded
public void columnAdded(TableColumnModelEvent e)
Код приложения не должен вызывать эти методы напрямую; они используются внутри JTable.
- Определено в:
-
columnAddedв интерфейсеTableColumnModelListener - Параметры:
-
e— полученное событие - См. также:
columnRemoved
public void columnRemoved(TableColumnModelEvent e)
Код приложения не должен вызывать эти методы напрямую; они используются внутри JTable.
- Определено в:
-
columnRemovedв интерфейсеTableColumnModelListener - Параметры:
-
e— полученное событие - См. также:
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— полученное событие - См. также:
createDefaultColumnModel
protected TableColumnModel createDefaultColumnModel()
DefaultTableColumnModel. Подкласс может переопределить этот метод, чтобы вернуть другой объект модели столбцов.- Возвращает:
- объект модели столбцов по умолчанию
createDefaultRenderer
protected TableCellRenderer createDefaultRenderer()
TableColumn не задан визуализатор заголовка.- Возвращает:
- визуализатор столбцов таблицы по умолчанию
- Начиная с версии:
- 1.3
initializeLocalVars
protected void initializeLocalVars()
resizeAndRepaint
public void resizeAndRepaint()
revalidate, за которым следует вызов repaint.setDraggedColumn
public void setDraggedColumn(TableColumn aColumn)
draggedColumn заголовка значение aColumn. Код приложения не должен вызывать этот метод напрямую; он используется внутренним механизмом перетаскивания столбцов.
- Параметры:
-
aColumn— перетаскиваемый столбец илиnull, если ни один столбец не перетаскивается
setDraggedDistance
public void setDraggedDistance(int distance)
draggedDistance заголовка значение distance.- Параметры:
-
distance— расстояние перетаскивания
setResizingColumn
public void setResizingColumn(TableColumn aColumn)
resizingColumn заголовка значение aColumn. Код приложения не должен вызывать этот метод напрямую; он используется внутренним механизмом изменения размера столбцов.
- Параметры:
-
aColumn— изменяемый столбец илиnull, если ни один столбец не изменяется
paramString
protected String paramString()
JTableHeader. Этот метод предназначен только для отладки; содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null. Переопределите paramString, чтобы предоставить сведения о новых особенностях компонентов JFC.
- Переопределяет:
-
paramStringв классеJComponent - Возвращает:
- строковое представление этого объекта
JTableHeader
getAccessibleContext
public AccessibleContext getAccessibleContext()
- Определено в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеComponent - Возвращает:
- AccessibleJTableHeader, служащий объектом AccessibleContext для этого JTableHeader
© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/table/JTableHeader.html