Класс 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, который инициализирован с cm в качестве модели столбцов. |
Краткое описание методов
| 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 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)
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)
- Переопределяет:
-
getPreferredSizeв классеJComponent - Возвращает:
- размер
- См. также:
getUI
public TableHeaderUI getUI()
- Overrides:
-
getUIв классеJComponent - Возвращает:
- объект
TableHeaderUIтемы оформления, отображающий этот компонент
setUI
public void setUI(TableHeaderUI ui)
- Параметры:
-
ui- объектTableHeaderUIтемы оформления - См. также:
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 не определяет рендерер заголовка.- Возвращает:
- рендерер столбцов таблицы по умолчанию
- С тех пор:
- 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, 2021, 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/17/docs/api/java.desktop/javax/swing/table/JTableHeader.html