Класс JTableHeader
- Все реализованные интерфейсы:
-
ImageObserver,MenuContainer,Serializable,EventListener,Accessible,TableColumnModelListener
public class JTableHeader extends JComponent implements TableColumnModelListener, Accessible
JTable. Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками 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, инициализированный с помощью columnModel в качестве модели столбцов. |
Краткое описание методов
| Modifier and Type | Method | Description |
|---|---|---|
void |
columnAdded |
Вызывается при добавлении столбца в модель столбцов таблицы. |
int |
columnAtPoint |
Возвращает индекс столбца, в котором point находится, или -1, если он находится вне границ. |
void |
columnMarginChanged |
Вызывается при перемещении столбца из-за изменения отступа. |
void |
columnMoved |
Вызывается при изменении позиции столбца. |
void |
columnRemoved |
Вызывается при удалении столбца из модели столбцов таблицы. |
void |
columnSelectionChanged |
Вызывается при изменении модели выбора TableColumnModel. |
protected TableColumnModel |
createDefaultColumnModel() |
Возвращает объект модели столбцов по умолчанию, который является DefaultTableColumnModel. |
protected TableCellRenderer |
createDefaultRenderer() |
Возвращает рендерер по умолчанию, который используется, когда TableColumn не определен TableColumn. |
AccessibleContext |
getAccessibleContext() |
Получает AccessibleContext, связанный с этим заголовком JTable. |
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) изменился. |
Methods declared in class 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
Methods declared in class 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
Methods declared in class 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. Если 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, если изменение размера столбцов разрешено - См. также:
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)
TableColumn.- Параметры:
-
defaultRenderer- рендерер по умолчанию - Since:
- 1.3
getDefaultRenderer
public TableCellRenderer getDefaultRenderer()
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)
- Переопределяет:
-
getPreferredSizeв классеJComponent - Возвращает:
- размер
- См. также:
getUI
public TableHeaderUI getUI()
- Переопределяет:
-
getUIв классеJComponent - Возвращает:
- объект
TableHeaderUIоформления, который отображает этот компонент
setUI
public void setUI(TableHeaderUI ui)
- Параметры:
-
ui- объектTableHeaderUIоформления L&F - См. также:
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, 2023, 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/21/docs/api/java.desktop/javax/swing/table/JTableHeader.html