Класс JTableHeader
- Все реализованные интерфейсы:
-
ImageObserver,MenuContainer,Serializable,EventListener,Accessible,TableColumnModelListener
public class JTableHeader extends JComponent implements TableColumnModelListener, Accessible
Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. Пожалуйста, обратитесь к XMLEncoder.
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class |
JTableHeader.AccessibleJTableHeader |
Этот класс реализует поддержку доступности для класса JTableHeader. |
Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent
JComponent.AccessibleJComponent
Вложенные классы/интерфейсы, объявленные в классе java.awt.Container
Container.AccessibleAWTContainer
Вложенные классы/интерфейсы, объявленные в классе java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected TableColumnModel |
columnModel |
Заголовок таблицы. |
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 v1.3. |
Поля, объявленные в классе javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Поля, объявленные в классе java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Поля, объявленные в интерфейсе java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
JTableHeader() |
Создаёт JTableHeader с параметрами по умолчанию. |
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 platform v1.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 platform v1.3. |
void |
updateUI() |
Уведомление от UIManager о том, что внешний вид (L&F) изменился. |
Методы, объявленные в классе javax.swing.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
Методы, объявленные в классе java.awt.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
Методы, объявленные в классе java.awt.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
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
public JTableHeader(TableColumnModel cm)
cm является null, этот метод инициализирует заголовок таблицы с моделью столбцов по умолчанию.- Параметры:
-
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, если отображение таблицы должно разрешать изменение размера; иначе false - См. также:
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, если отображение таблицы должно обновлять тело таблицы в реальном времени
getUpdateTableInRealTime
public boolean getUpdateTableInRealTime()
- Возвращает:
- true, если таблица обновляется в реальном времени
setDefaultRenderer
public void setDefaultRenderer(TableCellRenderer defaultRenderer)
headerRenderer не определён TableColumn.- Параметры:
-
defaultRenderer- рендерер по умолчанию - Since:
- 1.3
getDefaultRenderer
public TableCellRenderer getDefaultRenderer()
headerRenderer не определён TableColumn.- Возвращает:
- рендерер по умолчанию
- Since:
- 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)
- Overrides:
-
getPreferredSizeв классеJComponent - Возвращает:
- размер
- См. также:
getUI
public TableHeaderUI getUI()
- Overrides:
-
getUIв классеJComponent - Возвращает:
- объект
TableHeaderUI, который отрисовывает этот компонент
setUI
public void setUI(TableHeaderUI ui)
- Параметры:
-
ui- объект внешнего вида L&F - См. также:
updateUI
public void updateUI()
UIManager о том, что внешний вид (L&F) изменился. Заменяет текущий объект UI последней версией из UIManager.- Overrides:
-
updateUIв классеJComponent - См. также:
getUIClassID
public String getUIClassID()
- Overrides:
-
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.- Возвращает:
- рендерер столбцов таблицы по умолчанию
- Since:
- 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.
- Overrides:
-
paramStringв классеJComponent - Возвращает:
- строковое представление этого
JTableHeader
getAccessibleContext
public AccessibleContext getAccessibleContext()
- Определено в:
-
getAccessibleContextв интерфейсеAccessible - Overrides:
-
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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/table/JTableHeader.html